home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / role / NH31P3_1.lzh / NetHack / ReadMe < prev    next >
Text File  |  1993-07-18  |  12KB  |  282 lines
  1.  
  2.           Using and Installing Amiga NetHack 3.1
  3.       (or Everything You Never Wanted to Know Before NetHacking)
  4.  
  5.          Last Revision: 18 June 1993 for NetHack 3.1.3
  6.  
  7.  
  8. 0. Pre-intro for NetHack 3.1.3.
  9.    New for 3.1.3:
  10.      Updated this file: new binary release organization and missing options.
  11.      Fixed PAL screen calculation error.
  12.      Improved font characters for walls, floor, wands, doors, and swallowed.
  13.    New for 3.1.2:
  14.      Addition of asksavedisk option to eliminate need for savedir;n syntax
  15.      Scrolling message window if screen is tall enough.
  16.      Consolidation of defaults and config information into one in HackWB.
  17.      All known fatal bugs dealing with the Amiga port have been fixed.
  18.      Preliminary tty mode - see below.
  19.      
  20.    We would like to thank each and every one of the people who took
  21.    the time and effort to report bugs to us.  THANK YOU!
  22.  
  23. I. Introduction
  24.  
  25. I.A. Overview
  26.     Welcome to Amiga NetHack!  If this is your first visit to our fair
  27.     city, you are in for an amazing and dangerous journey; if you have
  28.     visited us before, beware! the city has changed in many strange and
  29.     subtle ways; it has also grown quite a bit.  This missive brings to
  30.     light those mundane tasks which must be dealt with before beginning
  31.     your journey; for those of you who are faced with the task of
  32.     installing the pre-fabricated version of our town, section III
  33.     (Installing Amiga NetHack 3.1) will guide you through the task at
  34.     hand.  If you are ready to visit, the local visitors guide is in
  35.     section II (Using Amiga NetHack 3.1); please also see the general
  36.     guide packaged separately (the file GuideBook).
  37.     
  38.     To all our visitors, a hearty Welcome! - and please be careful.
  39.  
  40.     [Those responsible for the previous paragraphs have been sacked.  The
  41.     documentation has been completed at great expense in a more traditional
  42.     style. -- The Management]
  43.  
  44. I.B. Getting Help
  45.     If you have questions about strategy, weapons, or monsters, the best
  46.     place to go for help is the Usenet newsgroup rec.games.hack.  If you
  47.     have problems with installation or think you have found a bug in
  48.     the game, please report it by electronic mail to the development
  49.     group at nethack-bugs@linc.cis.upenn.edu, where it will be routed
  50.     to the appropriate person.  Include your configuration, the version of
  51.     NetHack you are playing, and as much specific information as possible.
  52.     As NetHack runs on many different machines, be sure to mention that
  53.     you are playing the Amiga version.  Finally, if you are having trouble
  54.     compiling NetHack, you may use the same address, or, for compiler
  55.     specific problems, send mail to:
  56.         Greg Olson (golson@sundown.sun.com) for Manx.
  57.         Richard Addison (addison@pollux.usc.edu) for SAS/C.
  58.     We do not currently have a contact for the DICE port.
  59.  
  60. I.C. Credits
  61.     Olaf Seibert first ported NetHack 2.3 and 3.0 to the Amiga.  Richard
  62.     Addison, Jochen Erwied, Mark Gooderum, Ken Lorber, Greg Olson, Mike
  63.     Passaretti, and Gregg Wonderly polished and extended the 3.0 and 3.1
  64.     ports.
  65.  
  66.  
  67. II. Using Amiga NetHack 3.1
  68.     The short version: from the WorkBench click on HackWB and from the
  69.     CLI invoke HackCli.
  70.  
  71. II.A. Sources of Information
  72.     Where to go depends on what you want to find out.  If you want to find
  73.     out about distributing NetHack, read the license (in NetHack:license or
  74.     type ?i during the game).  For an introduction to NetHack, read the
  75.     GuideBook file.  Finally, for information during the game on all kinds
  76.     of things, type ? and select from the menu.  Further information on
  77.     HackWB is below and available from HackWB - press the Help key; more
  78.     information on HackCli is in the NetHack ManPage.
  79.  
  80. II.B. The Amiga NetHack WorkBench Front End
  81.     The Amiga NetHack WorkBench Front End, HackWB, looks more or less like a
  82.     WorkBench Drawer - and acts the same way.  Games start with double clicks
  83.     and menus provide more detailed control of games and defaults.  On-line
  84.     help is available - just press the help key.
  85.  
  86.     Just as with WorkBench itself, options for games are set using the Info
  87.     menu item to modify Tooltypes.  Most common options can be set more 
  88.     easily using buttons available via Info also.
  89.  
  90.     If necessary, you can adjust the following using the ToolTypes from the
  91.     Info command:
  92.  
  93.     * OPTIONS=<options> - Options as available in the NetHack.cnf file.
  94.  
  95.     * HACKDIR=<directory> - Set NetHack working directory to be this
  96.       directory.
  97.  
  98.     * LEVELS=<levels> - Intermediate level saving device/directory.
  99.  
  100.     * PATH=<path> - To search for files such as rumors, help, etc.
  101.  
  102.     * CMDLINE=<args> - Arguments as passed on the CLI command line.
  103.       Note:  only the following flags are valid: n, X, D, and r.
  104.  
  105.     * SCORE <options> - Display the record of scores.  Options as
  106.       available on the CLI command line after a -s flag.
  107.  
  108.     * FONT=name.font:size - Set font used for text on screens which are
  109.       tall enough (>250 lines).
  110.  
  111.     * PENS=col0/col1/.../col7 - Set palette colors.
  112.  
  113.     Note that the NetHack.cnf file is read first, then the ToolTypes.  This
  114.     means that the options specified in the NetHack.cnf act as defaults
  115.     which can be overridden by an individual's personal icon's ToolTypes.
  116.     Thus the system oriented entries (HACKDIR, LEVELS, and PATH) should
  117.     generally be set only in NetHack.cnf.  NetHack.cnf should have default
  118.     values for OPTIONS, which will generally be overridden by ToolTypes
  119.     entries.
  120.  
  121.     Also, there are two additional options that may be specified in the
  122.     NetHack.cnf file or on an OPTIONS line: flush and silent.  When enabled,
  123.     flush discards all characters in the queue except the first, which limits
  124.     typeahead accidents.  The default setting is noflush.  Silent turns off
  125.     the audio output.
  126.  
  127.     Usually, most of the confusing options will be set in the NetHack.cnf
  128.     file once when the game is installed and can be ignored after that.
  129.  
  130. II.C. The Amiga NetHack CLI Front End
  131.     The CLI Front End, HackCli, provides the standard Unix-like command line
  132.     interface to NetHack.  Unlike the Unix front end however, the CLI front
  133.     end will ask if you want to play again (and optionally change the
  134.     arguments) before exiting.  See the ManPage file for the standard Unix
  135.     flags for NetHack.  In addition to those flags, Amiga NetHack accepts
  136.     flags -l to force non-interlaced mode and -L to force interlaced mode.
  137.  
  138.  
  139. III. Installing Amiga NetHack 3.1
  140.  
  141. III.A. General Installation
  142.     Installation should be easy - basically it consists of putting files
  143.     where they belong and adding assigns to your startup.  If you are
  144.     installing from the official binary distribution, simply unpacking
  145.     each archive in the appropriate directory will put the files in the
  146.     places they belong (note that the archives may have been split
  147.     for distribution).  If you are installing from source, most of this
  148.     work will be done by the time the build is finished.  See below for
  149.     complete installation instructions.
  150.  
  151.     IF YOU ALREADY HAVE A PREVIOUS VERSION INSTALLED YOU MUST DELETE THE
  152.     OLD SAVE AND BONES FILES - THEY WILL NOT WORK!  This includes save
  153.     and bones files from NetHack 3.1.0 and 3.1.1.
  154.  
  155. Will NetHack fit on your machine?
  156.     NetHack 3.1 is large.  NetHack 3.1 is very large.  You will need:
  157.     > Amiga 500, 1000, 2000, 2500, 3000, or 4000.  The A600, and A1200
  158.       should work, but have not been tested.
  159.     > WorkBench 1.3 or 2.04 or later.  WorkBench 1.2 or 2.02 will NOT work;
  160.       we will NOT be fixing that. 
  161.     > At least 2 meg of RAM.  NetHack will NOT run in 1 meg.
  162.     > Mass storage: NetHack will run on one floppy - but it won't be nice.
  163.       Two floppies are almost enough.  A hard drive with over 3 meg of
  164.       free space is recommended.
  165.  
  166. Find space for the files
  167.     Floppy installation:
  168.     Format five disks named:
  169.         NetHack
  170.         HackExe
  171.         HackExe2
  172.         NHsave
  173.         NHlevels
  174.     Hard Disk installation:
  175.         cd to wherever you want to install NetHack
  176.     make a new directory to be the main NetHack directory:
  177.       makedir NH313
  178.       makedir NH313/NetHack
  179.       makedir NH313/HackExe
  180.       makedir NH313/HackExe2
  181.     In S:User-Startup (under 2.0 or later) or S:Startup-Sequence
  182.     (under 1.3):
  183.       assign NetHack: to the NetHack directory you created above.
  184.       assign HackExe: to the HackExe directory.
  185.       assign HackExe2: to the HackExe2 directory.
  186.  
  187. Install the files
  188.     Unpack the archives in the directories or onto the disks.  Cd to
  189.     the appropriate places then unpack the files:
  190.     Archive 1 (the one this ReadMe came in), should be unpacked into
  191.     NetHack:.  If you are installing to hard disk, cd to the NH313 directory
  192.     before unpacking.
  193.       lz x NH31P3-1.lzh
  194.     Archive 2 unpacks in two sections to two different places.  If you are
  195.     installing to hard disk, cd to the NH313 directory before unpacking; if
  196.     you are installing to floppies, unpack each section to a different disk.
  197.       lz x NH31P3-2.lzh HackExe/#?
  198.       lz x NH31P3-2.lzh HackExe2/#?
  199.       
  200.     Use the table in the next section to see where things should end up.
  201.     Be sure that the file 8 ends up in NetHack:hack/8 and that the sounds
  202.     files end up in the NetHack:sounds directory.
  203.  
  204. Floppy fixup
  205.     If you are installing to floppies the files on each disk are probably one
  206.     level too far down (for example NetHack:NetHack.cnf is probably
  207.     NetHack:NetHack/NetHack.cnf).  This is how to fix that:
  208.     Put the following lines into the file ram:fixit (be sure to delete the
  209.     blanks from the start of the lines or this will NOT work!)
  210.       .key x
  211.       rename <x> /<x>
  212.  
  213.     For each of the disks NH313, NetHack, and HackExe, cd into the "inner"
  214.     directory (for example "cd NetHack:NetHack") and execute these commands:
  215.       list >ram:x lformat="execute ram:fixit %s" #?
  216.       execute ram:x
  217.  
  218. Configuration
  219.     Using your favorite text editor, edit NetHack:NetHack.cnf to match
  220.     your system.  Check HackExe:NetHack.dir and be sure that the paths
  221.     are correct (note that the C or D beginning the line is required and
  222.     is not part of the file path).  The HackWB program uses two standard
  223.     Amiga programs that must be installed in their standard places: c:copy
  224.     and c:rename.  The icons for the documentation invoke SYS:Utilities/More
  225.     and will probably need to be updated for your installation.
  226.  
  227.     If you want a log kept of each game, execute this line:
  228.     echo to NetHack:logfile
  229.  
  230.     If you are installing to a hard disk, installation is complete.
  231.  
  232.     If you are installing to floppies, you must format a disk for save files
  233.     and one for levels files.  Edit NetHack.cnf and change the SAVE= and
  234.     LEVELS= lines to match.
  235.  
  236. III.B. File Location Table
  237. NetHack:
  238.     amii.hlp    cmdhelp        data        default.icon
  239.     dungeon        Guidebook    Guidebook.info    hack.font
  240.     hack/8        HackCli        HackCli.info    HackWB
  241.     HackWB.hlp    HackWB.info    help        hh
  242.     history        license        ManPage        ManPage.info
  243.     NetHack.cnf    NewGame.info    opthelp        options
  244.     oracles        quest.dat    ReadMe        ReadMe.info
  245.     Recover        Recover.info    RecoverMan    RecoverMan.info    
  246.     rumors
  247.     sounds/Bell            sounds/Bugle
  248.     sounds/Drum_Of_Earthquake    sounds/Fire_Horn
  249.     sounds/Frost_Horn        sounds/Leather_Drum
  250.     sounds/Magic_Flute        sounds/Magic_Harp
  251.     sounds/Tooled_Horn        sounds/Wooden_Flute
  252.     sounds/Wooden_Harp
  253.     wizhelp
  254.  
  255. HackExe:
  256.     A-filla.lev    A-fillb.lev    A-goal.lev    A-locate.lev
  257.     A-start.lev    air.lev        asmodeus.lev    astral.lev
  258.     B-filla.lev    B-fillb.lev    B-goal.lev    B-locate.lev
  259.     B-start.lev    baalz.lev    bigroom.lev    C-filla.lev
  260.     C-fillb.lev    C-goal.lev    C-locate.lev    C-start.lev
  261.     castle.lev    E-filla.lev    E-fillb.lev    E-goal.lev
  262.     E-locate.lev    E-start.lev    earth.lev    fakewiz1.lev
  263.     fakewiz2.lev    fire.lev    H-filla.lev    H-fillb.lev
  264.     H-goal.lev    H-locate.lev    H-start.lev    juiblex.lev
  265.     K-filla.lev    K-fillb.lev    K-goal.lev    K-locate.lev
  266.     K-start.lev    knox.lev    medusa-1.lev    medusa-2.lev
  267.     minefill.lev    minetown.lev    mine_end.lev    NetHack.c01
  268.     NetHack.d00    NetHack.dir    oracle.lev    orcus.lev
  269.     P-filla.lev    P-fillb.lev    P-goal.lev    P-locate.lev
  270.     P-start.lev    R-filla.lev    R-fillb.lev    R-goal.lev
  271.     R-locate.lev    R-start.lev    S-filla.lev    S-fillb.lev
  272.     S-goal.lev    S-locate.lev    S-start.lev    sanctum.lev
  273.     T-filla.lev    T-fillb.lev    T-goal.lev    T-locate.lev
  274.     T-start.lev    tower1.lev    tower2.lev    tower3.lev
  275.     V-filla.lev    V-fillb.lev    V-goal.lev    V-locate.lev
  276.     V-start.lev    valley.lev    W-filla.lev    W-fillb.lev
  277.     W-goal.lev    W-locate.lev    W-start.lev    water.lev
  278.     wizard1.lev    wizard2.lev    wizard3.lev
  279.  
  280. HackExe2:
  281.     NetHack.c00
  282.